home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / s2a_v101.arc / S2A.DOC < prev    next >
Text File  |  1991-07-15  |  9KB  |  179 lines
  1.  
  2.  
  3.  
  4.                                Send-2-All  v1.0
  5.                               Copyright (C) 1991
  6.                                   Kit Cragin
  7.  
  8.                      A SysOp and User Bulletin Generator
  9.  
  10.                Please distribute freely, with no modifications.
  11.  
  12.             ┌────────────────────────────────────────────────────┐
  13.             │    For the latest updates and awesome shareware    │
  14.             │    call MAELSTROM, FIDO - 1:117/341                │
  15.             │  Node 1: (409) 696 8722  1200/2400 soon USR HST DS │
  16.             │  Node 2: (409) 764 6516  1200/2400 MNP 5           │
  17.             └────────────────────────────────────────────────────┘
  18.  
  19.    DESCRIPTION
  20.    ~~~~~~~~~~~
  21.    Send-2-All is an editor that allows SYSOPS AND USERS to create bulletins
  22.    which  are added to an  ANSI or ASCII  file of bulletins.  The bulletins
  23.    will be  automatically removed  when they  expire.  A daily  maintenance
  24.    program will monitor the bulletins and update accordingly.  It will  run
  25.    on any Remote Access v0.03 and above BBS or QuickBBS based BBS.  The ed-
  26.    itor generates ASCII & ANSI bulletins but runs in ANSI mode only!
  27.  
  28.    This archive should contain the following files.  If it doesn't,  find a
  29.    a legitimate copy and use it instead.
  30.  
  31.    S2A.EXE        The main program.  Allows users & you to edit  bulletins.
  32.    S2AMAINT.EXE   Runs daily maintenance by checking for expired bulletins.
  33.    CONFIG.DAT     The configuration file for S2A and S2AMAINT.
  34.    BADWORDS.DAT   The file of illegal words and/or control sequences.
  35.    S2A.DOC        You're reading it.
  36.    REGISTER.ME!   The registration form for a low cost good bulletin maker.
  37.  
  38.    The file TWITUSER.DAT is  optional and to be  created by you, the sysop.
  39.    The files BULLETIN.DAT and USERINFO.DAT will be created by the program.
  40.  
  41.    FEATURES
  42.    ~~~~~~~~
  43.    A variety of Sysop configurable features has been created to make use of
  44.    this program easy and flexible.
  45.  
  46.    - Colors and box borders can be changed (see CONFIG.DAT file).
  47.    - Generation of both ANSI or ASCII  bulletins to any filename/directory.
  48.    - Allows or disallows user 'S' aborting of the display file.
  49.    - Limit the number of total bulletins and number allowed per user.
  50.    - Choose the maximum number of days before a user's bulletin expires.
  51.    - Allows the sysop to force delete bulletins.
  52.    - Disallows 'TWIT' users from using the bulletin generator.
  53.    - Stops 'BAD' words from being entered by the user via the  BADWORDS.DAT
  54.      file.
  55.    - Stops invalid  control sequences from being  entered, for example ANSI
  56.      sequences and RA/QBBS control sequences via the BADWORDS.DAT file.
  57.    - Displays most current bulletins first.
  58.    - Supports multi-node systems.
  59.    - Exits with errorlevel 100 on 'S'ave  bulletin option or  when a change
  60.      occurs with the bulletins.  (Useful if  you  want 2 copies of the same
  61.      file, or want to generate a report or something).
  62.  
  63.    DISCLAIMER
  64.    ~~~~~~~~~~
  65.    In no way is the author of  this product  liable for any damages done to
  66.    to your system's hardware or software or any system you run this product
  67.    on.
  68.  
  69.    RESTRICTIONS/REGISTRATION
  70.    ~~~~~~~~~~~~~~~~~~~~~~~~~
  71.    Feel free to pass  this software on to others  (via upload or whatever).
  72.    But be sure there are no  modifications of  any kind,  and that  all the
  73.    files listed in the DESCRIPTION above are included.
  74.  
  75.    This software is NOT public domain. It is shareware. This means that you
  76.    can use  it for a limited  amount of  time before you  either  decide to
  77.    register it, or discontinue use. In this case you can evaluate this pro-
  78.    duct for 21 days.  At that time you should support the shareware concept
  79.    by filling out the form in REGISTER.ME  and sending in a paltry $12;  or
  80.    not use this product further.
  81.  
  82.    Registration entitles you to the full-featured version which:
  83.  
  84.    - Allows the use of more than one color in the text.
  85.    - Allows sysop to define the max # of bulletins a user can post per day/
  86.      week/month/year.
  87.    - Will support more than one set of bulletins. (eg.  a different  format
  88.      can be set up for logoff comments, etc)
  89.    - Entitles you to free, REGISTERED upgrades as they become available.
  90.    - Manages seasonal bulletins (display holiday bulletins on holidays etc)
  91.    - True multi-node support (ie. simultaneous editing)
  92.    - Allows the sysop to edit any previously created bulletin, and the user
  93.      to edit one of his  previous bulletins.  This  is useful  if a meeting
  94.      date changes,  or if someone wants to  sell  something  at a different
  95.      price, for example.
  96.  
  97.    Registration  also  gives me an incentive to create new interesting  and
  98.    useful programs for YOU! On behalf of all shareware authors, please sup-
  99.    port shareware!
  100.  
  101.    CONFIGURATION
  102.    ~~~~~~~~~~~~~
  103.    I have designed this program to be as simple and easy to set up as poss-
  104.    ible,  because I know that many  sysops hate to waste time writing batch
  105.    files and testing new programs.  If you follow the steps below, the pro-
  106.    grams should run without a hitch; if not, call the BBS above and leave a
  107.    message. I will get back to you ASAP.  No changing of directories, batch
  108.    files or environment variables are needed!
  109.  
  110.      1.  Make sure that all of the files in this archive are in a directory
  111.          together,  usually in some  subdirectory off of your  BBS or doors
  112.          directory
  113.  
  114.      2.  Modify one of your .MNU files to include an option for Send-2-All.
  115.          A.  Create a type 7 or 15 exit.
  116.          B.  For OPTIONAL DATA,  type in the full path  and filename of the
  117.              program,  then put the path  to your DORINFO  and EXITINFO.BBS
  118.              files and then the *B parameter (Baudrate).
  119.  
  120.                       eg.  C:\BBS\DOORS\SEND2ALL\S2A.EXE C:\BBS *B
  121.  
  122.      3.  In your BBS batch file,  or wherever you do daily maintenance, add
  123.          a line to run the maintenance program, S2AMAINT.EXE.
  124.  
  125.                       eg.  C:\BBS\DOORS\SEND2ALL\S2AMAINT
  126.  
  127.      4.  Edit the CONFIG.DAT file to configure the colors and other options
  128.          to your taste. See the CONFIG.DAT file for more information.
  129.  
  130.      5.  Edit the BADWORDS.DAT file as needed.   This is a file of words or
  131.          characters/control sequences that you don't  want to appear in the
  132.          users' bulletins. For distribution purposes I have included in the
  133.          file  the ASCII #6, #11, and  ESCape characters.  For  the sake of
  134.          decency, I will leave adding bad words to the file up to you. Just
  135.          make sure that each is entered on a line by itself, up to 15 char-
  136.          acters each, 200 words total.  The program scans for any occurence
  137.          of the pattern in the line, so  if you have 'DUDE' in BADWORDS.DAT
  138.          the  word 'Dudes' will be  flagged as BAD in the text.  To prevent
  139.          this put ' DUDE ' in BADWORDS.DAT instead; note the  spaces before
  140.          and after-^----^.
  141.  
  142.      6.  Edit TWITUSER.DAT as needed.  Delete it if you do not plan to use
  143.          it. Put one name per line. This is a plain ASCII file.
  144.  
  145.      NOTE: The files in STEPS 5 & 6 are optional. BADWORDS.DAT is recommen-
  146.            ded, however. CASE does not matter in the files.
  147.  
  148.      RUNNING THE PROGRAMS
  149.      ~~~~~~~~~~~~~~~~~~~~
  150.      - To delete  specific bulletins,  run S2AMAINT with numbers after  the
  151.        filename (eg. S2AMAINT 2 3 6 23  will delete bulletins 2,3,6, and 23
  152.        even if they have not yet expired.
  153.      - To run the program locally, type S2A /L <YourFirstName> <YourLastName>
  154.      - Directions for using S2A are given by hitting '?' in the program.
  155.      - Call the BBS above for any other help, comments, suggestions etc or
  156.        contact me in the FIDO DOORWARE echo.
  157.      - To start the bulletin generator 'from scratch', delete BULLETIN.DAT
  158.        and USERINFO.DAT if they exist.
  159.      - While a user  is on-line,  the sysop can hit the down arrow  key to
  160.        reduce the user's time, or Alt-L to force an immediate exit.
  161.  
  162.      MULTI-NODE OPERATION
  163.      ~~~~~~~~~~~~~~~~~~~~
  164.      If your system has multiple nodes and if you put 'T' in the CONFIG.DAT
  165.      file  on  the multi-node line,  then S2A will  automatically check for
  166.      the existance of the file INUSE,  which is a temporary file signalling
  167.      that the program is in use.  If it  exists a message will be displayed
  168.      that tells the user to  try again later.  INUSE is removed  at program
  169.      termination.
  170.  
  171.      I hope you find Send-2-All useful.
  172.      Enjoy the program!
  173.                          Kit
  174.  
  175.                                Send-2-All  v1.0
  176.                               Copyright (C) 1991
  177.                                   Kit Cragin
  178.  
  179.